Comp6to1

Comp6to1
Header:	Sound.h		Carbon status:	Unsupported

Compresses sound data at a ratio of 6:1.

void Comp6to1 (
    const void *inBuffer, 
    void *outBuffer, 
    UInt32 cnt, 
    StateBlockPtr inState, 
    StateBlockPtr outState, 
    UInt32 numChannels, 
    UInt32 whichChannel
);

Parameter descriptions

inBuffer: A pointer to a buffer of samples to be compressed.
outBuffer: A pointer to a buffer where the samples are to be written.
cnt: The number of samples to compress.
inState: A pointer to a 128-byte buffer from which the input state of the algorithm is read, or NULL. To initialize the algorithm, this buffer should be filled with zeros.
outState: A pointer to a 128-byte buffer to which the output state of the algorithm is written, or NULL. This buffer might be the same as that specified by the inState parameter.
numChannels: The number of channels in the buffer pointed to by the inBuffer parameter.
whichChannel: The channel to compress, when numChannels is greater than 1. This parameter must be in the range of 1 to numChannels.

DISCUSSION

The Comp6to1 function compresses cnt samples of sound stored in the buffer specified by inBuffer and places the result in the buffer specified by outBuffer, which must be at least cnt/6 bytes in size. The Comp6to1 function works much like the Comp3to1 function, but compresses every 48 bytes of sound data to exactly 8 bytes of compressed sound data and compresses remaining bytes to no more than one-sixth the original size.

SPECIAL CONSIDERATIONS

Because the Comp6to1 function might allocate and dispose of memory, you should not call it at interrupt time.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

You should use the sound converter routines instead.